home *** CD-ROM | disk | FTP | other *** search
/ Magnum One / Magnum One (Mid-American Digital) (Disc Manufacturing).iso / d21 / dvload.arc / DVLOAD.MAN < prev    next >
Text File  |  1988-07-08  |  2KB  |  54 lines
  1. DVLOAD.EXE          CADIS Technical Manual
  2.  
  3.  
  4. NAME
  5.      dvload - Load a Desqview application from DOS command line.
  6.  
  7. SYNOPSIS
  8.      dvload PIF-prefix ["parameters"]
  9.  
  10. DESCRIPTION
  11.      DVLOAD is a Desqview-specific program that loads and runs a Desqview
  12.      application as if it were loaded from the "open window" menu in Desqview. 
  13.      A Desqview application is defined as an executable program that has a
  14.      Desqview PIF (Program Information File).  These files can normally be
  15.      found in the Desqview default directory, and are created from the "open
  16.      window" menu by selecting "CP" (change program) or "AP" (add program).
  17.      They are of this form: nn-PIF.DVP where nn is the prefix.
  18.  
  19.      DVLOAD searches the command line for a two character PIF prefix, and an
  20.      optional parameter string.  The string must be enclosed in quotes if
  21.      there are any embedded spaces.  The PIF is loaded into memory, and the
  22.      parameter string is mapped into the PIF.  Desqview is then called and
  23.      loading takes place.  Control will return to DVLOAD when the loaded
  24.      application finishes execution, which then exits.
  25.  
  26. EXAMPLES
  27.      dvload wp grunt  (load PIF wp-pif.dvp, and pass the parameter "grunt")
  28.      dvload co        (load PIF co-pif.dvp, no paramters)
  29.  
  30. DIAGNOSTICS
  31.      DVLOAD returns with the following errorlevel codes:
  32.  
  33.           errorlevel
  34.                1   desqview is not loaded.
  35.                2   error on opening PIF file.     
  36.                3   error on reading PIF file.
  37.                4   error on starting application. 
  38.                5   error in command line options.
  39.      
  40. NOTES
  41.      Because of Desqview limitations, the parameter string is limited to 63
  42.      characters.  Any information after position 63 is ignored.
  43.     
  44.      The PIF files are searched for in c:\dv.  This is coded into the program.
  45.  
  46.      The API library only seems to work reliably under Desqview 2.01.  Thus
  47.      this program is only recomended to run under 2.10 
  48.  
  49.      The .exe was compiled under Turbo C 1.5
  50.  
  51. BUGS
  52.      PIF prefixes must be 2 characters.  Unknown results if only one character
  53.      is passed to the program.
  54.